home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 101-125 / disk_108 / alist / alist.doc < prev    next >
Text File  |  1992-05-06  |  6KB  |  125 lines
  1.      AList command for the CLI ... use as a replacement for List and Dir.
  2.  
  3.      Version 0.06 (dated 02-Sep-1987 at 21:13:42).
  4.  
  5.      Based (loosely) on LD4 by Dave Haynie for directory access, "Dir"
  6. for the idea of sorting the entries and "List" for output content.
  7.  
  8. Usage: AList [>prt:] [dirname] [opt pcvl23 | -c -l42 -p -v]\n
  9.                         CasE is NOT significant ... mix & match, if you like.
  10.                         Except for ">prt:" first, order is NOT significant.
  11.  
  12.                     ? = display command format.
  13.  
  14.        where: dirname = the Amiga drive (df0:, dh1:, etc.), the name of
  15.                         a disk (WorkBench:, etc.) or a full path name, as
  16.                         WorkBench:devs/keymaps.
  17.  
  18.                     c = color display desired (orange directories).
  19.  
  20.                     l = number of lines to display before pausing, value
  21.                         may be 3 (although DUMB) through 999.
  22.  
  23.                     p = re-directing to printer ... you tell AList that you
  24.                         used ">prt:" in the command line, and AList indents
  25.                         its output so there is room to punch holes in the
  26.                         list for storing in a binder.  Please note that a
  27.                         form-feed will initiate the listing!
  28.  
  29.                     v = verbose ... displays the current version data, and
  30.                         displays the number of files/directories during the
  31.                         input/sort phase.
  32.  
  33.                   opt = "Dir" format of specifying options.
  34.  
  35.                     - = Compiler format of specifying options.
  36.  
  37.                         Use whichever format turns you on, but not both!
  38.  
  39.   anything unexpected = DISPLAY COMMAND FORMAT.
  40.  
  41.      If you are re-directing to the printer (>prt:), you can now use "v",
  42. as the display of the number of files/directories found will be eliminated.
  43. The use of the "c" option has no value in re-direction unless you have a
  44. color printer ... it won't hurt, but it sure won't generate color!
  45.                   
  46.      If no argument is supplied, the current directory will be displayed.
  47.  
  48.  
  49. F_i_l_e___N_a_m_e_____________ _Keys_ __Size_ Blocks MM-DDD-YYYY HH:MM:SS
  50. WorkBench_1.2     (BOLD)          880    Root      0 27-Jul-1987 22:19:40
  51. TrashCan.info     (normal)        889     654      2 27-Jul-1987 22:19:38
  52. c                 (italicized)    882     Dir      0 27-Jul-1987 22:10:13
  53.   AList           (indented)      884   17828     36 29-Aug-1987 13:55:12
  54.  
  55.                etc.  I took great pains to ensure that everything would
  56. line up properly under the headings, to maximize readability.  File names
  57. belonging to a sub-directory are indented to catch the eye.
  58.  
  59.      I am including source code for this, my first Amiga programming effort,
  60. my first program in "C", so that some expert out there may be able to tell
  61. me why some of the flaky things happen every now and then ... like 1,248
  62. bytes not being returned to "Free Memory" EVERY time "AList" is run.  I am
  63. using AList every session myself, but with 2.5M the 1248 is not a problem,
  64. but for someone on a 256K Amiga (or even 512K) you need to get it all back!
  65.  
  66.      I am releasing the Lattice 3.10 "C" source code to Fred Fish, local
  67. bulletin boards and maybe even Commodore-Amiga.  It may be used freely by
  68. anyone brave enough to do so, modified, extended or --->TrashCan.  If you
  69. do use the command, especially if you find (and fix) any bugs, I would
  70. appreciate a letter telling me what the problem is(/was) and any fixes you
  71. have made.
  72.  
  73. Bugs fixed:
  74.  
  75.     Version 0.06:
  76.             Disk icons will now disappear when you eject the disk after the
  77.          use of "AList" on it ... I've cleared ALL the Lock's (I hope).
  78.             No more "GURU" meditations when using "AList" on the current
  79.          directory.  (I now only clear Lock's I have set.)  Sometimes the
  80.          problem manifested itself in the NEXT CLI command hanging/GURUing.
  81.  
  82.     Version 0.03:
  83.             Long disk volume names are no longer a problem ... try AList on
  84.          "Copy of WorkBench 1.2" on this version if you downloaded v0.00.
  85.  
  86.             Aesthetics ... you don't HAVE to see "AList compiled on ... ".
  87.  
  88.             Statistics ... you CAN get the number of files/directories.
  89.  
  90. Bugs(?) to be fixed in a later version:
  91.  
  92.             Approximately 1,248 characters are NOT returned to Free Memory
  93.          after EACH run of "AList".  When I find out what is not being
  94.          "Free"d, I will Free it (providing its mine to Free!).
  95.             Support for control-c (^c) to break early ... why you'd want
  96.          to break I don't know, but since you can now ^c "Dir", I may as
  97.          well try to duplicate as much of "Dir" as possible in "AList",
  98.  
  99. Features to be added in a later version:
  100.  
  101.             Option "p" will result in "AList" doing the output to "prt:",
  102.          so you don't have to use ">prt:" in the command line.
  103.             Option "d" will be added for compatibility with "Dir" (for any
  104.          of you brave enough to replace Dir with AList, but habitually use
  105.          opt d from time-to-time).
  106.             I may also add Opt "i" if I get any requests for it, but
  107.          "I DON'T DO DELETES!".
  108.  
  109. CAVEAT!!!
  110.             Since I don't support ^c in AList, don't use the #@%*& thing,
  111.          as you're going to get a "GURU", sure as my name's Ed Kivi!
  112.  
  113. Hope you find this creation amusing/useful/instructive/(?), so Enjoy!
  114.  
  115. Please address any comments, bug reports, postage stamps, etc. to:
  116.  
  117.                           A. Edwin Kivi
  118.                           ** SUGAR
  119.                           P. O. Box 5970
  120.                           Lacey, WA  98503
  121.  
  122.                           "C"'ya (signed) Ed Kivi
  123.  
  124. **  SUGAR = Sunset User Group / Amiga Resources
  125.